home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d7
/
host41.arc
/
HOST41.DOC
< prev
next >
Wrap
Text File
|
1990-02-13
|
41KB
|
937 lines
HOST41.SLC and H41UTILS.SLC are SALT language scripts compiled to
run under the TELIX.EXE (C) telecommunications program.
H O S T 4 1 / H 4 1 U T I L S
This program is distributed under the Shareware concept.
Non-Registered users of HOST41 are granted a limited license to
use it for a 4 week trial period, in order to determine it's
usefulness to you. ANY other use of HOST41 after that period is
strictly prohibited.
WHY REGISTER?
* Registration allows you to use HOST41 on a regular basis.
* Registered users will receive mailed notification of updates
to the program.
* Registered users will also receive top priority in any help
or comments they have/need.
* Registered users receive copies of program which has the
"UNREGISTERED" statement removed and replaced with one which
says "REGISTERED TO:" and which gives their names.
* Registered copies of HOST41 have the limit on messages and
files raised from 25 (current limit on UNREGISTERED versions
of HOST41) to a higher limit of 99 messages and 999 files.
* Registered users receive two additional support programs:
H41UEDIT.EXE : A true full-screen external user editor allows
editing of ALL user information, as well as
easy addition of new users.
MENUEDIT.EXE : A full-screen Menu Editing program which allows
Reading and Writing to each specific menu. Thus
enabling the sysop to personalize the different
menus.
Registration is $20.00 and covers all of the above features.
To Order:
Make check or money order out to:
Daniel Horn
2122 West Butler Drive #161
Phoenix, AZ 85021
-----------------------------------------------------------------
Please send:
HOST41 Registration .............. $ 20.00 _____
{ Print }
Name :______________________________________________________
Address:______________________________________________________
______________________________________________________
______________________________________________________
Day Phone:(____)______-_______ Evening:(____)______-_______
Current version I have ______
Comments:_____________________________________________________
_____________________________________________________
_____________________________________________________
{ Optional }
Computer Type:________________________________________________
Color display [Y/N]: __
Where did you hear about (and/or receive a copy of) HOST41?
{ } BBS Name______________________ Ph #(____)______-_______
{ } Sig Name________________________________________________
{ } CompuServe
{ } Friend
{ } Other ____________________________________________________
-----------------------------------------------------------------
This program evolved from the original HOST.SLC/HCONFIG.SLC
programs, and then the later revisions by Jon Flemming found in
HOST2.SLC/H2CONFIG.SLC.
HOST3 was written as a sort of pet project of mine, in order
to enhance the HOST2.SLC program, written by Jon Flemming. I felt
that although he had made some superb changes to Colin's original
HOST.SLC, there was SO much more that could be done to make the
program even better. So, I began working on it. And this is
what I have come up with so far...hope you enjoy it!
These are the files needed to run the HOST41 program. Some
of these will be created as needed, as well some of them are only
optional:
HOST41.SLC - Main Host Mode file, must be in your telix
script directory.
H41UTILS.SLC - Utilities script, it contains all of the
utilities. It is called by the HOST3.SLC
program. It should also be in your telix
script directory. Do not try to run this by
itself!
MENUS41.DAT - This is the file which contains all of the
menus for each of the levels as well as the
sections.
H41COMP.EXE - This is the file which does all the data file
compression. It can be run via DOS and the
command line, or internally using the provided
the provided user interfaces.
(see section entitled "Data File Compression")
USER41.DAT - This is the file that holds all of the user
information, it is created by HOST41.SLC. It
will be created in your telix directory.
(See section on CONVERT)
HOST41.LOG - This file is created by the HOST31 program, it
is a log of all user logon's, and what each one
[ user ] does when on the system. It will be
created in your telix directory.
HCONVERT.EXE - This program will allow you to convert your
HOST3 or HOST31 user data files into the new
HOST41 data format.
OPTIONAL FILES:
GATEWAY2.SYS - This is the program which can control the I/O
during the time when a user shell's to DOS,
as well as when they view an archive. This
file should be in your root directory.
(see the section entitled "OPTIONAL EXTERNAL
FILES" for more information)
*.ASC/*.ANS - There are eight text files that are only truly
optional. These files will need to be in your
telix directory, if you are going to be using
them. (see "OPTIONAL EXTERNAL FILES")
HSHELL.BAT - This batch file if in the Telix directory will
be run automatically if the shell to DOS option
has been executed from the Main Menu.
(see section entitled "OPTIONAL EXTERNAL FILES"
for more information)
BLTS41.DAT - This is a pure ASCII data file which (if used),
contains information regarding the text files
which are to be used as bulletins.
(see section entitled "OPTIONAL EXTERNAL FILES"
for more information regarding format)
DOORWAY.EXE - This fine program by Marshall Dudley, if in
the Telix directory, will be used in the shell
to DOS unless overridden by the existence of
HSHELL.BAT.
(see section entitled "OPTIONAL EXTERNAL FILES
" for more information)
INSTALLATION
This is really a very easy program to install. Below are
some step by step instructions on installing it:
1) Put the HOST41.SLC/H41UTILS.SLC files into your Telix
script directory. (See Telix docs on setting a default
script directory.)
2) Run Telix, and then when in Telix run the HOST41 script.
(ALT-G, then type in HOST41). HOST41 will search for the
configuration file, and then will automatically run the
H41UTILS.SLC program. Input all the variables needed in
the program and then choose the "X" (Exit and Save). See
the section "H41UTILS ( The Configuration Program )" for
more detail on the configuration of HOST41.
ACCESS LEVELS AND WHAT EACH CAN DO
There are four access levels in this program. This section
will describe what each level can do.
Level 0: This is the level of a new user that logs on, he/she can
not do much of anything on the board, except to chat,
leave a comment to sysop, or to change their defaults.
Optionally, the Sysop can have them logged off once they
have input all of the information.
Level 1: This is your basic user level. The user can do most
of the things available (except for a few things below),
but there are a few limits placed on the user. For one,
the user can only download a certain limit per call, (as
specified in the configuration. As well they can only
download from the download directory, and can NOT use
the extract archives command.
Level 2: This user is the same as the level 1 user, but does not
have a download limit, and can use the extract archives
command.
Level 3: This user can not only do all the Level 2 user can, but
can also download files from ANY directory on your disk,
they can also look at the daily user log, and can do a
"Shell to DOS" IF they know the system password. (Which
is defined in the configuration program).
Level 4: Your basic Sysop level. Currently this level can do the
exact same thing as the Level 3 user with one addition.
Having this level gives the user the option of shutting
down the system remotely, I would reserve this level for
yourself (the sysop) only, but if you have a extremely
good friend...well, that's up to you.
LIST OF USERS COMMANDS
This is a list of all user commands, and what each can do.
It is separated into sections by levels, each higher level can
do what the previous can do.
Level 0
[P]age: If the sysop is available, this command will ring a bell
calling you to chat, otherwise it will print a message
saying that the sysop isn't available, then the user has
the option of leaving a private message to you.
[X]pert: This function allows the user to change his expertise
level, to one of three levels:
NOVICE: Gives a menu of commands.
INTERMEDIATE: Gives the command letters as part of
the input line.
EXPERT: NO help whatsoever!
[G]oodbye: Log's the user off.
[Y]our Defaults: Lets the user change their address, city, zip,
state, choose a default protocol, and turn the
pause function on or off.
[C]omments to Sysop: This option will allow the user to write a
private message to the sysop.
(assumes there is a user using the name of
SYSOP!)
Level 1
[B]ulletins: This option goes to the bulletins menu which allows
the user to read them (if any)
[M]essage Base: This option allows the user to go to the message
base system. Following is a list of commands
available to them in the message base.
[R]ead Messages: This allows the user to read the messages in the
the message base.
[W]rite Messages: This allows the user to write a message to a
user (either Public or Private).
[Q]uit to Main Menu: This allows the user to go back to the main
menu
[F]ile System: This option allows the user to go to the File Base
System. Following is a list of commands available
to them in the File Base.
[D]ownload: Let's the user Download files. Level 1 can only
download a specified limit. Levels 3+ can download
from ANY directory.
[U]pload: Allows user to upload a file (if it is not already in
the file database) to the system.
[F]iles List: This shows the user a listing of the files which
are available at their level.
[X]tended File List: This allows the user to see a listing of the
files available at his level, but includes
the uploader, aprox. time for transfer, and
more.
[T]ype Text File: Types a text file out to the screen, pause can
be turned on or off in the user defaults, as
well, hitting Ctrl-P will pause, and Ctrl-X
will abort the listing at any time. Levels 3+
can type files in ANY directory.
[V]iew Archive: Lets the user view a archive. Levels 3+ can view
archives in ANY directory.
[Q]uit to Main Menu: This allows the user to go back to the main
menu.
Level 2
File Base System Commands:
[E]xtract from archives: This lets the user extract files
from a archive, the file is then
archived (using PKZIP), into a temp
file called ( TEMPARC.ZIP ), it is
deleted when the user hangs up
Level 3
[S]hell to DOS: This lets the user shell to DOS. If the user is
remote (not keyboard) then they will be prompted
for the system password, if they fail to enter
it they will not be able to shell.
IMPORTANT!!!!: There is NO current way to check on the status of
the carrier. Due to this fact, if the carrier is
lost while a user is in DOS (via remote) then the
SYSTEM WILL HANG!. The only solution if this is
to happen is to reboot the computer.
System [L]og: This shows the user the daily usage log, hit Ctrl-
P to pause, Ctrl-X to abort.
Message Base Commands:
[K]ill Messages: This allows the user (level 3+) to 'Kill' a
message. Level 3 can only remove ones to
or from him (or her), while Level 4 can
remove ANY message.
File Base Commands:
[R]emove File: This allows the user (level 3+) to remove a
file from the database.
[C]hange File: This allows the user (level 3+) to change
the file information in the database.
Level 4
Control-Z: This lets the user shut down the system. The user is
is prompted for the system password, if they fail the
program will continue running.
Message Base Commands:
[P]ack Database: This allows the user (level 4 only) to do a
pack of the message base (it is a interface
to the H41COMP.EXE program).
File Base Commands:
[P]ack Database: This allows the user (level 4 only) to do a
pack of the file base (it is a interface
to the H41COMP.EXE program).
SYSOP'S KEYBOARD COMMANDS
This is a list of the commands available to the sysop, not
all commands are available at all times.
WHEN NO USER IS ONLINE
F1: This turns chat on or off, the line in the status box shows
the current condition of chat. (If chat is turned off during
the Chat hours, then the "OFF" will be in red).
(See "H31UTILS (The Configuration Program)" for more detail
on Chat Hours).
F2: This brings up the user editor, note that there must be at
least ONE user, otherwise the user editor will NOT work.
(See "H31UTILS (The User Editor)"for more information on the
user editor)
C: This runs the configuration program.
U: This will run the user compressor program, this will delete
any old or deleted users. NOTE: There must be at least one
user in the user file, or the compressor will not run.
HOME: This brings up a box giving all the online commands.
ESC: This will exit the program and go back to Telix.
WHEN A USER IS ONLINE
F1: Turn chat on or off (same as above)
F2: Run user editor (same as above)
F3: Temporarily lower the users access.
F4: Temporarily raise the users access.
F5: Temporarily lower the time allowed.
F6: Temporarily raise the time allowed.
F9: Shell to DOS (the user can not see)
F10: Chat with user.
END: Terminate user.
ESC: Exit program to Telix.
HOME: Bring up the help box.
H41UTILS.SLC
(The configuration program)
This program will allow you to change some important data in
the HOST3 program. This section will tell what each category is
for:
NOTE: The options in the section "Page 2" are all located on a
separate page in the configuration program. They can be
accessed by pressing PgDn. Once in the second page you may
return to the first page by hitting PgUp.
Page 1
Download directory: This is the directory that the users will be
downloading from. It will be a sub-directory
of your Telix directory. If it is not a legal
directory (doesn't exist) it will be created.
Upload directory: This is the directory that all uploads will go
into. It will also be a sub-directory and will
created if it does not exist.
Connection: This is how your computer will be connected. Usually
it will be MODEM(unless you plan to run on a network)
System Password: This is the password that is needed to shut down
the system, or to shell to DOS.
Archive Directory: This is the directory that your archive utils.
are found in. It must be a EXACT directory
or the program will NOT be able to do anything
dealing with archives (VIEW/TEST/EXTRACT), the
program will support (ARC/PAK/ZIP), but there
must be these files.
For *.ARC's:
PKPAK.EXE
PKUNPAK.EXE
For *.ZIP's:
PKZIP.EXE
PKUNZIP.EXE
For *.PAK's:
PAK.EXE
(must have these commands!)
View: "V"
Test: "T"
Extract: "X"
Access limit: This is the limit (in K's!) that a level 1 user can
download per call.
Time Chat is to come on: This is the time that you would like the
"Chatting times" to start at. Chat will
come on (regardless of current setting),
at this time, and will stay on (UNLESS
shutoff manually, if done, the "OFF" in
the status box will turn red), and will
go off at the off time.
Time Chat is to go off: This is the time that you would like the
"Chatting times" to end at.
(NOTE: Due to problems with some logic statements, the
Chatting times can NOT extend over midnight. You
may have chat on until 11:59pm, and can have it
come on at 12:01am. As well, it is not possible
to have chat on for more then 12 hours.)
Page 2
Log off new users: This (if on) will immediately log off any new
users as soon as they finish logging on. This
allows you to keep new users off the system
completely until you can validate them.
Number of Downloads: This is the number of downloads (per one
upload) a user can make. If they attempt
to download more then they can then they
will be told they need to upload more.
User log on alarm: This is a little alarm that (if on) will ring
when a user logs on.
Time per access level: This is a integer (in minutes) which is
given to a user, per access level. For
example, if it was 20, a 2nd level user
would be given 40 mins, while a 3rd level
user would get 60 mins.
Level of Uploads: This is the access level that a uploaded file
would be given once received. If it is set to
a 1 then all access levels can see it. If set
to 3 then only access levels of 3 and 4 could
see it. This can be changed by changing its
level via the "Change File" option in the file
section.
Auto Baud Detect: This controls the auto baud detect of the BBS.
If ON, the BBS will change the modem to the
speed of the connection. If OFF it will leave
the modem to change on it's own. This option
is primarily for high speed modems or for ones
which have error correction modes where the
port speed should remain constant.
Configure Colors: This option allows the sysop to change the BBS
side (NOT ANSI Colors!) colors, ie. the status
bar colors/config option colors etc.
H41UTILS.SLC
(The User Editor)
This is the User Editor. This will allow you to change some
information about the user. There are two sections in this part.
One is about the different functions in the Editor, the other is
about the different immediately.
Movement
There are some special keys in the Editor that will move you
around.
Up Arrow : This will move you up one category
Down Arrow : This will move you down one category
Page Up : This moves you to the top of the categories
Page Down : This moves you to the end of the categories
Left Arrow : This moves you to the next user
Right Arrow: This moves you to the previous user
Control - V: This will take you to the next NEW user
Control - S: This will initiate a search through the users
names for a string (input by you)
CATEGORIES
Users Name: This is the users name
Users Password: This is the users password
Users Access: This is the users access level
Users Flag: This is the users status flag, A is Active, D is
Delete, and B is Blacklist.
Users Phone: This is the users phone number
Users Address: This is the users address, it is divided into
four parts. The Address, City, State, and
Zip code
User Comment: This is a place to put a comment in
Last on: This shows when the user was last on
Downloads: This shows how many downloads the user has made
Uploads: This shows how many uploads the user has made
NOTE: There must be at least one user in the user file, or the
Editor will not run.
OPTIONAL EXTERNAL FILES
*.ASC/*.ANS - These eight (four *.ASC/four *.ANS) files which you
create yourself, if found in the Telix directory,
will be displayed to the user at certain times as
follows:
LOGON.* : This file is displayed when a user first logs on
NEWS.* : This file is displayed after a user has logged on
and they have successfully entered their password
BYEBYE.* : This file is displayed when the user quits the
BBS.
NEWUSER.* : This file is displayed to all new users.
IMPORTANT!: The input buffer for these files is set at the level
of 255 characters per line. If your files have more
characters per line they will NOT be sent correctly!
NOTE: For some reason I have been having some problems with some
ANSI graphics screens. I'm not sure exactly why, but it
occurs mostly when typing a large animated ANSI picture, I
hope to have this fixed by the next version. Try different
line sizes if you have problems (best way is NOT using any
animation!)
HSHELL.BAT - This batch file if found in the Telix directory will
be run when a online user does a shell to DOS. It
will override ALL other shell options. The order in
which the shell options take precedence is:
HSHELL.BAT
DOORWAY.EXE
GATEWAY2.SYS
CTTY COMX
DOORWAY.EXE - This program if found in the Telix directory and
the previous shell option has failed will be run as
a shell to DOS for the online user. It will allow
the user to run MOST major programs online if the
user has a Communications program which can support
a Doorway Mode.
GATEWAY2.SYS - If installed and all previous options have failed
GATEWAY2.SYS will be used. To install, add the
following line to your CONFIG.SYS file:
DEVICE = GATEWAY2.SYS -D -(COM PORT)
Where (COM PORT) stands for the com port that your
modem is in. For example (the modem is in com 2):
DEVICE = GATEWAY2.SYS -D -2
For more information regarding Installation and
more details about GATEWAY2.SYS read the included
GATEWAY2.DOC file.
Unlike DOORWAY.EXE using GATEWAY2.SYS will NOT let
you run programs that use direct screen writes,
(Most MAJOR programs!) Do *NOT* attempt to run a
program which uses direct screen writes and direct
keyboard scans as it will LOCK your computer up!
BLTS41.DAT - This is a straight ASCII file which you can create,
that contains the information for some bulletins.
(Five bulletins total). Each bulletin takes up one
line in the file. The information for them are in
this format:
DRIVE:\PATH\FILENAME.EXT;Displayed information
Where Drive:\Path\Filename.ext is the EXACT path and
name of the bulletin, and Displayed information is
information displayed to the user, with the two
being separated by a semicolon ';'. For example:
C:\DOS\DOCS\REGISTER.DOC;Info on registering.
Where the document REGISTER.DOC being the file to be
displayed and the user would see the bulletin as:
1 Info on registering.
Data File Compression
H41COMP.EXE
This program will allow you to compress the three different data
files. The three being the user data file, the message base data
file and the file base data file. The program may be run either
from within HOST41 (User Compressor, and Pack Base commands in
both Message Base and File Database), or from the DOS Prompt. By
typing H41COMP at the dos prompt you will be shown a listing of
the different commands. Briefly those commands are:
P - Path To Data files: For when you are running the program from
a directory OTHER then the directory the
data files are in. Example usage:
H41COMP p\TELIX
U - Compress User File: This command runs the user compressor it
has one extra optional switch which is:
D:(x) - Days since last call
Where (x) is a number of days allowed for
users to have last connected. If it is
not used the program will default to 30.
M - Compress Message Base: This command runs the message base
compressor. It has two extra optional
switches:
K - Kill Private
This switch will delete *ALL* private
mail which has been read.
D:(x) - Days to allow
Where (x) is number of days allowed to
keep old messages. Default setting is
30 days.
F - Compress File Database: This runs the file base compressor it
has three extra optional switches:
D - Sort By Date
This switch will do a sort based upon
the file date as opposed to a normal
alphabetical sort.
R - Reverse Sort
This switch reverses the sort routine
making it sort the greatest (be it in
date or alphabetically) first and the
smallest last (ie files would be Z-A)
K - Kill files not found
This switch causes the program to run
a check on each file to see if it is
actually there. If the file is NOT
found, then it will be removed from
the database.
Converting Previous File Formats
HCONVERT.EXE
This program will let you convert your user data files from both
HOST3 and HOST31 into the new HOST41 data format. Just place this
program in the same directory as your data file is in and type:
HCONVERT
At the DOS prompt. It will then prompt you to choose which data
format you wish to convert FROM. Pick the proper format and it
will then convert it for you. HCONVERT will erase the old data
file and leave you with the new USER41.DAT file. You should keep
a backup of the old data file when running HCONVERT, in the event
that something goes wrong. You might also need to do some minor
editing of the data file in some extreme cases where the old data
file was slightly corrupted.
DISCLAIMER
This program is provided as is, and is to be run at your own
risk. There is NO warranty of any kind or form covering this
program. Exis Inc., Colin Sampaleanu, and the author are not in
any way, or shape, responsible, or liable for any damages of any
kind that may arise from the usage of this program, or that of
any programs, or files associated, or included with it.
TELIX.EXE, SALT, HOST.SLC, HCONFIG.SLC: Copyright 1986,1987,
1988, 1989 by Exis Inc., and Colin Sampaleanu.
Used with permission.
DOORWAY.EXE Copyright 1987, 1988, 1989 by Marshall Dudley.
Used without permission.
THANKS
There are a few people to who I would like to give special
thanks to, for their help and cooperation in my endeavor to
create this program:
Marvin Blackburn: My *FIRST* registered user and my most
important beta tester, his input and
support have done the most for HOST!
Thank you VERY much Marvin!
Tony Gentile: My friend and C "teacher" who taught me the
basics of the C language, which helped a
GREAT deal when working on this program.
Thanks Tony.
Bill Parfitt: The sysop of dBored (619-748-3644), who not
only gave me a LOT of support, but gave me a
good place to put my program as well, but
also gave me my own conference!
VERY special thanks to you Bill!
And finally,
Colin Sampaleanu:
For the extremely hard work and numerous, uncounted hours
that he has put into creating TELIX, which is the very BEST (in
my opinion) telecommunications program package out there!
Without it this program wouldn't be around.
EXTRA thanks to you Colin!
WHAT'S NEW?
o Added configurability of BBS sided colors.
o Added support for MNP/High Speed Modems.
o Added small Message Base system.
o Added small File Database system.
o Added Bulletins (up to five)
o Added HotKey's.
o Added more protocols to list (ALL protocols Telix
provides are now usable)
o Wrote External file compressor, allows for faster
file compression as well as sorting of files in the
file database.
o Wrote External User Editor for registered user, has
access to ALL user information and is full screen.
o Wrote External Menu Editor for registered user. It
allows them to change the menus to their liking.
o Changed Menu setup to a tri-menu system.
o Changed Scroll Method to one where Statusline stays
permanent.
o Completely rewrite code (3 times!), and was able to
fit MORE code into less space, all the new features
were added in only 20k!
o Changed way ANSI is sent, thus providing support for
future user changeable ANSI colors.
o Increased Speed of Operation slightly.
o Fixed bug in HOST31 user defaults.
WHAT'S AHEAD IN THE FUTURE?
Now that Colin has increased the size of scripts from 32K to
64K I have some more room to work in (about 13K now). So now I
can add more of my last want list, as well as some new ideas.
Full Screen Message Editor: This will allow the users to
write their messages in a full
screen editor, allowing full
cursor control and more editing
features.
Online Programs: A online sysop definable program section
which will be able to run door programs,
including some SALT door scripts which are
already being written.
BBS List: A full working BBS listing program, where the a
user can add information about other BBS's.
CallBack Door: This is a scripted DOOR which is a CallBack
Verification door. It is already written
and has been beta tested already.
ANSI Configuration: This will allow the user to choose which
ANSI colors they want to have the HOST
use. This is PERSONALIZED and will be
saved as part of the user information.
External Protocols: Will allow the sysop to add some (up to
four), external protocols. (Telix only
only has space for four protocols).
TECHNICAL SUPPORT
If you have any suggestions or ideas for the next version,
or any problems, or, (God forbid), bugs. You may get a hold of
me at these locations.
BEST WAY!-> dBored of San Diego, (619) 748-3644
(Prodoor Conf. HOST3)
Telix Support BBS, (416) 439-8239
PCRelay, Communications conference
PCRelay, Telix Conference
FIDO Net Telix Conference
Or mail me:
Daniel Horn
2122 West Butler Drive #161
Phoenix, AZ 85021
